Bentley Map V8i (SELECTseries 10) Help

PPF Tokens

Table 1. PPF Tokens
Token Effect
FILE Describes the full path and file name of the DGN from which the print takes place. If no path is specified with the design file name, the directory containing the PPF is searched.
Note: This is required for batch printing.

Format: FILE = c:\saved DGNs\temp\example.dgn

MODEL Chooses the model to open within a DGN file. If not used, the open model during the last time the settings were saved is used.
Note: This only applies to MicroStation V8 and above.

Format: MODEL = model name

OUTPUT Describes the full path and file name of the destination file to which the print will take place. If no path is specified with the filename, the output is sent to the directory defined by the CS_PLTFILES configuration variable. If this token is not used, the plot file is output to the same directory as the PPF file and with the same filename as the PPF and a .ps extension.

Format: OUTPUT = c:\output dir\temp\example.ps

FENCE_SHAPE Creates a fence from which to print. This provides a means of defining a shape with n number of vertices (n being less than 101).

A shape is created by placing the vertices in order until the number of points is reached and then the first and last points are joined to create a closed shape. This shape becomes the fence used in the print. The order of the points is important.

Note: Coordinates are in working units.

Format: FENCE_SHAPE = NUMBER_OF_POINTS (x1, y1) (x2, y2) (x3, y3) (x4, y4) (x5, y5) (x6, y6)....

FENCE_RECT Places rectangular fences from which to print. Point 1 is the lower left corner of the rectangle and point 2 is the upper right corner of the rectangle. The angle of rotation ( )represents an angle above or below the x-axis.
Note: Coordinates are in working units

Format: FENCE_RECT = (x1, y1) (x2, y2) ANGLE_OF_ROTATION

AREA_CELLS Causes Bentley Advanced Map Finishing to search for the existence of particular cells and creates plots bounded by the extents of each cell. A plot is created for each cell that exists. The output filename is appended with an incrementing number for each plot. This is an alternative to defining an area to print using fixed coordinates.
Note: Cells do not need to be displayed to be scanned.

Format: AREA_CELLS = "Cell name";{Level};{Logical Name}

{Level} is optional. If omitted the cell can be on any level.

{Logical Name} is optional. If omitted the current DGN and all references are scanned. If only the master file is to be scanned use MASTER_FILE, else use the reference file logical name.

AREA_CELLS = "Letter";;
AREA_CELLS = "A4"; Sheet Areas; 
MASTER_FILE
AREA_EXTENTS Causes Bentley Advanced Map Finishing to set the plot fence to the extents of elements in the current DGN file and/or references. You can limit the extent calculation to particular elements.
Note: Extents are only calculated using visible elements.

Format: AREA_EXTENTS = {Level 1},{Level 2}...{Level n};{Logical Name}

{Level l1}...{Level n} is a comma separated list of levels. If omitted all levels are scanned.

{Logical Name} is optional. If omitted the current DGN and all references are scanned. If only the master file is to be scanned use MASTER_FILE, else use the reference file logical name.

AREA_EXTENTS = ; Plot extents of all element in all files.

AREA_EXTENTS = ; MASTER_FILE Plot extents of only the master file.

AREA_EXTENTS = Title;Sheet Plot extents of level "Title" from reference "Sheet".

AREA_SHAPES Performs like except Bentley Advanced Map Finishing creates plots bounded by shape elements found in the current DGN and/or references.
Note: Shape elements do not need to be displayed to be scanned.

Format: AREA_SHAPES = {<Level>};{<colour>};{<Style>};{<Weight>};{Logical Name}{Level}, {colour};{Style};{<Weight>};

{Logical Name} is optional. If omitted the current DGN and all references are scanned. If only the master file is to be scanned use MASTER_FILE, else use the reference file logical name.

Shapes can be selected using the value BYLEVEL for colour, weight, and style. If not using BYLEVEL for these items the value matches with the effective colour, weight, and style if the a shape's symbology is actually defined BYLEVEL.

AREA_SHAPES = Borders; 2; 0; 0;
AREA_SHAPES = Borders; 2; 0; 0;
MASTER_FILE
AREA_SHAPES =
Borders; 2; 0; 0;
Sheets
AREA_SHAPES =  Borders; 2; BYLEVEL; 
BYLEVEL; Sheets 
VIEW

Relates to the view in which the print takes place.

Format: VIEW = n

where: n is between 1-8.

VI Relates to saved views or named views within DGN's. To work, the view must have been saved previously. This is the same as the key-in VI in MicroStation.
Note: The RV token can interfere with this setting if is appears after this token.

Format: VI = SAVED_VIEW

RV Relates to rotating views within DGN's. The is the same as the key-in RV in MicroStation.
Note: The angle of rotation is in degrees and the VI token can interfere with this setting if is appears after this token.

Format: RV = ANGLE_OF_ROTATION

LV Sets the levels displayed in the master file for the view set by the VIEW token (otherwise set for View 1).

Format: LV = Default, Roads, Rivers, Coastline

or as LV = 1,3,634,45,46-63 for MSJ

COLOUR

Determines whether the print is to be performed in colour or black and white.

Note: For all tokens containing a True or False value, the letter T or F can be used.

Format: COLOUR= TRUE (or FALSE)

where: TRUE = Colour and FALSE = Black and White

SEPARATE Determines whether the print produces a colour-separated output (a file is produced for each: cyan, magenta, yellow, and black components).
Note: For this to work, the COLOUR token must be set to true.

Format: SEPARATE = TRUE (or FALSE)

where: TRUE = Produces colour separated output and FALSE = Produces one output containing all colour components.

WHITE_EQ_WHITE Relates to the "White equals White" feature in Bentley Advanced Map Finishing, if the attribute is set to true.
Note: For the WHITE_EQ_WHITE token to work, the COLOUR token must be set to true.

Format: WHITE_EQ_WHITE = TRUE (or FALSE)

where: TRUE = White equals white feature is on and FALSE = White equals white feature is off.

COLOUR_SCALES Modifies the colour of elements with an attached grayscale.
Note: For the COLOUR_SCALES token to work the colour token must be set to true.

Format: COLOUR_SCALES = TRUE (or FALSE)

where: TRUE = Modifies the colour Scales and FALSE = No modification of colour Scales.

PRINT_BORDER Places a border around the print area.

Format: PRINT_BORDER = TRUE (or FALSE)

where: TRUE = Places a border around the print area and FALSE = the print area contains no border.

PRINT_BORDER_TEXT Places text underneath the border containing relevant details about the DGN.

Format: PRINT_BORDER_TEXT = TRUE (or FALSE)

where: TRUE = Places a border text beneath the print area and FALSE = the print area contains no border text.

EPS_RASTER_HEADER_TYPE Specifies the type of raster header to be attached to the PostScript file.
Note: This token only works with EPS plots.

Format: EPS_RASTER_HEADER_TYPE = HEADER_TYPES_OPTIONS

where the HEADER_TYPES_OPTIONS are:

  • EPS_HEADER_NONE for no EPS header
  • EPS_HEADER_TIFF for TIFF header (most widely used and reliable header)
  • EPS_HEADER_EPSI for EPSE header (black and white only and is not always recognized).
EPS_RASTER_HEADER_RES

Represents the resolution of the EPS header.

Format: EPS_RASTER_HEADER_RES = n

Where: n is the integer value of the resolution. This value must be greater than 0.

LINE_FREQUENCY

Represents the frequency in lines per inch of dot patterns used to represent grayscales or colours on a print.

Note: The value of LINE_FREQUENCY has to be above 30.

Format: LINE_FREQUENCY = n

where: n is the integer value of the line frequency. If no value is entered, the default line frequency of the device is used.

DEVICE_RESOLUTION Represents the resolution of the output device.
Note: The value of DEVICE_RESOLUTION has to be above 0.

Format: DEVICE_RESOLUTION = n

where n is the integer value of the device resolution. If no value is entered, the default resolution of the device is used.

DOWNLOAD_PFBs

Determines whether PFB font files are downloaded when using non-resident font styles.

Format: DOWNLOAD_PFBs = TRUE (or FALSE)

where: TRUE = PRB font files are downloaded and FALSE = PRB font files are not downloaded, which can save processing time for preliminary plots.

ADD_CONTROL_D

Places a control D (^d) character (ASCII 04 decimal) at the beginning and end of each output file, unless paper type EPS is used. This character is not required to enable PostScript to work but can improve the operation of some printers.

Format: ADD_CONTROLD = TRUE (or FALSE)

where: TRUE = Places the control D (^d) character and FALSE = The control D (^d) character is not placed and the file remains untouched.

LINE_JOIN

Determines the shapes of corners in Postscript paths.

Format: LINE_JOIN = LINE_JOIN_OPTIONS

where the LINE_JOIN_OPTIONS are:

  • Miter
  • Round
  • Bevel
MITER_LIMIT

Determines the threshold angle when using a Mitre join option in the LINE_JOIN setting.

Format: MITER_LIMIT = n.nnnn

where: n.nnnn is the number value of the miter limit. This value must be at least 1.0.

LINE_CAPPING

Determines what capping is used on the end of lines.

Format: PAGE_UNITS = LINE_CAPPING_OPTIONS

where the LINE_CAPPING_OPTIONS are:

  • Normal
  • Round
  • Flat
EMULSION

Determines whether the film plate is emulsion side up or down when sending to image setters.

Format: EMULSION = TRUE (or FALSE)

where: TRUE = Film plate is down and FALSE = Film plate is up.

PAGE_UNITS

Specifies the units used to define the paper and print sizes.

Format: PAGE_UNITS = PAGE_UNITS_OPTIONS

where the PAGE_UNITS_OPTIONS are:

  • mm or millimeters
  • cm or centimeters
  • in or inches.
PAPER Sets the paper name which Bentley Advanced Map Finishing uses to determine paper size.
Note: If the PAPER_SIZE token appears after this token, its value is ignored.

Format: PAPER = PAPER_OPTIONS

where PAPER_OPTIONS is determined from Configure > Paper Sizes menu and needs to be set before this token can be used.

PAPER_SIZE Determines paper size of the print.
Note: If the PAPER token appears after this token, then its value will be ignored.

Format: PAPER_SIZE = (Width, Height)

where width and height are number values (in the form of n.nnnn) in the units set in the PAGE_UNITS token. These values must be greater than 0.0.

PAPER_WIDTH_MARGIN

Sets paper width of the margin for print.

Format: PAPER_WIDTH_MARGIN = n.nnnn

where n.nnnn is the number value of the margin width in the units set in the PAGE_UNITS token. This value must be greater than 0.0.

PAPER_HEIGHT_MARGIN Determines scale of the print size.
Note: The PAGE_UNITS token must be contained and set from within the PPF, otherwise the SCALE token cannot be set and results in error. If the PRINT_WIDTH or PRINT_HEIGHT tokens appear after this token, its value is ignored.

Format: SCALE = n.nnnn UNITS (DGN) per PAGE_UNITS (PAPER)

where: n.nnnn is the number value of the scale. This value must be greater than 0.0. The units of the DGN are the master units of the design file and the PAGE_UNITS token sets the units for the page.

SCALE Determines scale of the print size.
Note: The PAGE_UNITS token must be contained and set from within the PPF, otherwise the SCALE token cannot be set and results in error. If the PRINT_WIDTH or PRINT_HEIGHT tokens appear after this token, its value is ignored.

Format: SCALE = n.nnnn UNITS (DGN) per PAGE_UNITS (PAPER)

where: n.nnnn is the number value of the scale. This value must be greater than 0.0. The units of the DGN are the master units of the design file and the PAGE_UNITS token sets the units for the page.

PRINT_WIDTH Determines print width of the print.
Note: If the PRINT_HEIGHT or SCALE tokens appear after this token, its value is ignored.

Format: PRINT_WIDTH = n.nnnn

where: n.nnnn is the number value of the print width in the units set in the PAGE_UNITS token. This value must be greater than 0.0.

PRINT_HEIGHT Determines print height of the print.
Note: If the PRINT_WIDTH or SCALE tokens appear after this token then its value will be ignored.

Format: PRINT_HEIGHT = n.nnnn

where: n.nnnn is the number value of the print height in the units set in the PAGE_UNITS token. This value must be greater than 0.0.

ROTATE_TO_FIT Rotates the print so that it prints as large as possible on the paper, meaning alignment is at the longest side of the print area to the longest side of the paper.
Note: If the PRINT_WIDTH, PRINT_HEIGHT or SCALE tokens appear after this token then its value will be ignored.

Format: ROTATE_TO_FIT = TRUE (or FALSE)

where: TRUE = Rotate to Fit is turned on and FALSE = Rotate to Fit is turned off.

AUTO_CENTER Centers the image on the page.
Note: If the OFFSET_WIDTH or OFFSET_HEIGHT tokens appear after this token then its value will be ignored.

Format: AUTO_CENTER = TRUE (or FALSE)

where: TRUE = Print is centred on page and FALSE = Print is not center on page.

OFFSET_WIDTH

Determines size of the offset width.

Format: OFFSET_WIDTH = n.nnnn

where: n.nnnn is the number value of the offset width in the units set in the PAGE_UNITS token. This value must be greater than 0.0.

OFFSET_HEIGHT

Determines size of the offset height.

Format: OFFSET_HEIGHT = n.nnnn

where: n.nnnn is the number value of the offset height in the units set in the PAGE_UNITS token. This value must be greater than 0.0.

PHOTO_REDUCTION

Determines amount to which the DGN is scaled by a reduction factor. This is similar to scaling except that in Photo Reduction, line weights are reduced (or increased) by the reduction factor. In comparison, the scaling of line thickness is independent of the scale.

Format: PHOTO_REDUCTION = n.nnnn

where: n.nnnn is the number value of the PHOTO_REDUCTION. This value must be greater than 0.0.

ROTATION_ANGLE

Determines the rotation angle of the plot. This is different from rotating the view as the plot area also rotates whereas when you rotate the view the plot area remains orthogonal.

Format: ROTATION_ANGLE = n.nnnn

where: n.nnnn is the number value of the ROTATION_ANGLE. This value must be greater than 0.0.

GLOBAL_GAMMA

Determines global gamma value used with image compression.

Format: GLOBAL_GAMMA = n.nnnn

where: n.nnnn is the number value of the GLOBAL_GAMMA.

IMAGE_RESAMPLE

Determines the dpi factor used for image resampling.

Format: IMAGE_RESAMPLE = IMAGE_RESAMPLE_OPTIONS

where the IMAGE_RESAMPLE_OPTIONS are:

  • 72
  • 100
  • 150
  • 300
  • 600.
MONO_COMPRESS_MODE

Describes compression mode for monochrome index colour.

Format: MONO_COMPRESS_MODE = MONO_COMPRESS_MODE_OPTIONS

where the MONO_COMPRESS_MODE_OPTIONS are:

  • None
  • RLE
  • Group-3 Fax
  • Group-4 Fax
  • Deflate.
PALETTE_COMPRESS_MODE

Describes the compression mode for palette or grayscale index colours.

Format: PALETTE_COMPRESS_MODE= PALETTE_COMPRESS_MODE_OPTIONS

where the PALETTE _COMPRESS_MODE_OPTIONS are:

  • None
  • RLE
  • Deflate.
24_BIT_COMPRESS_MODE

Describes the compression mode for palette or grayscale index colours.

Format: 24_BIT_COMPRESS_MODE = 24_BIT_COMPRESS_MODE_OPTIONS

where the 24_BIT_COMPRESS_MODE_OPTIONS are:

  • None
  • RLE
  • JPEG.
Note: JPEG compression mode is a special case because a quality scale is associated with it. This scale is measured as a percentage, where 100% is the best quality, and is entered in the following format: 24_BIT_COMPRESS_MODE = JPEG, 100.
MSS_SUBMIT Submits the current job to a MAPscript queue.
Note: MAPscript needs to be set up correctly and the queue must be visible to the computer performing the print.

Format: MSS_SUBMIT = MAPscript Queue Name

USE_TABLE_ORDERING Controls the use table ordering when printing.
Note: Table ordering is turned on by default if table ordering has been used in the DGN.

Format: USE_TABLE_ORDERING = TRUE (or FALSE)

where: TRUE = Table ordering is used and FALSE = Table ordering is ignored (like turning off WYSIWYG).

LOAD_TABLE_ORDERING_FILE Specifies a Table Ordering File used in the printing process. Overrides table data attached to the DGN file being processed. Currently only binary .ORD files can be used.
Note: If used, the USE_TABLE_ORDERING token is not required as it is considered on.

Format: LOAD_TABLE_ORDERING_FILE = File name.ord

USE_TABLE_SYMBOLOGY

Controls the use table symbology when printing

Note: Table symbology is turned on by default if table ordering has been used in the DGN.

Format: USE_TABLE_SYMBOLOGY = TRUE (or FALSE)

where: TRUE = Table symbology is used and FALSE = Table symbology is ignored (like turning off WYSIWYG).

LOAD_TABLE_SYMBOLOGY_FILE

Specifies a Table Symbology File used in the printing process. Overrides any table data attached to the DGN file being processed. Currently only binary .SYM files can be used.

Note: If used, the USE_TABLE_SYMBOLOGY token is not required as it is considered on.

Format: LOAD_TABLE_SYMBOLOGY_FILE = File name.sym

LOAD_COLOUR_TABLE_FILE

Specifies a Colour Table File used in the printing process. Overrides any colour table data attached to the DGN file being processed. Currently only binary .CCT Bentley Advanced Map Finishing files and MicroStation's .TBL files can be used.

Format: LOAD_COLOUR_TABLE_FILE = File name.cct (or .tbl)

WATERMARK

Determines whether the print contains a watermark.

Format: WATERMARK = TRUE (or FALSE)

where: TRUE = Print contains watermark and FALSE = Print does not contain watermark.

WATERMARK_STRING

Determines what is printed as the watermark. The watermark string supports Bentley Advanced Map Finishing's text substitution.

Format: WATERMARK_STRING = STRING

where: STRING is any sequence of characters up to a maximum of 255 characters

WATERMARK_COLOUR

Determines the colour of the watermark text.

Format: WATERMARK_COLOUR = n

where: n is a number between 0-255 representing a colour on the MicroStation colour table.

WATERMARK_FONT

Determines the font of the watermark text.

Format: WATERMARK_FONT = n

where: n is the font number.

WATERMARK_JUST

Determines the justification of the watermark text.

Format: WATERMARK_JUST = n (or STRING)

where: n is a number and abbreviation is according to table. See WATERMARK_JUST Codes and Abbreviations.

WATERMARK_HEIGHT

Determines height of the watermark text (in master units). The width of the text is set at the same size as the height.

Format: WATERMARK_WEIGHT = n.nnnn

where: n.nnnn is the number value of the WATERMARK_WEIGHT and must be above 0.

WATERMARK_ANGLE

Determines angle of the watermark text.

Format: WATERMARK_ANGLE = n.nnnn

where: n.nnnn is the number value of the WATERMARK_ANGLE.

WATERMARK_ORIGIN_MU_X

Determines X coordinate of the origin of the watermark text (in master units).

Format: WATERMARK_ORIGIN_MU_X = n.nnnn

where: n.nnnn is the number value of the WATERMARK_ORIGIN_MU_X.

WATERMARK_ORIGIN_MU_Y

Determines Y coordinate of the origin of the watermark text (in master units).

Format: WATERMARK_ORIGIN_MU_Y = n.nnnn

where: n.nnnn is the number value of the WATERMARK_ORIGIN_MU_Y.

WATERMARK_TRANSPARENCY

Determines the font of the watermark text.

Format: WATERMARK_TRANSPARENCY = n

where: n is the WATERMARK_TRANSPARENCY between 0-100.

WINDOWS_PRINTER

Causes the resulting output of the batch file to be sent directly to the Windows Printer as specified by the printer name. Note that the destination printer must be a PostScript enabled device.

Format: WINDOWS_PRINTER=

OUTPUT_TYPE

Defined the output format of Bentley Advanced Map Finishing.

Values can either "PostScript", "EPS" or "PDF"

Default value is "PostScript"

Format: PDF_COLOUR = PDF

PDF_COLOUR

Specifies how the colour information is stored in resulting PDF files. Values can either "RGB" or "CMYK"

Default value is "RGB"

Format: PDF_COLOUR = CMYK

PDF_LEVEL

Specifies the format of PDF output.

Values range from:

1.4 - Acrobat 4

1.5 - Acrobat 6

1.6 - Acrobat 7

1.7 - Acrobat 8

Format: PDF_LEVEL = 1.7

PDF_PRECISION

PDF_PRECISION The precision property controls the number of digits after the decimal point used in coordinates written to the PDF file. Higher precision improves print quality, especially for Stroked text, at the expense of larger PDF file sizes.

The default precision, Standard, is designed to produce the smallest PDF file size with good text quality at printer resolution. PDF coordinates are rounded to 1/10th of a point. At high zoom levels in a PDF viewer, text may appear slightly deformed.

If the precision is set to Improved, text coordinates are rounded to 1/100th of a point while other coordinates are rounded to 1/10th of a point. This setting is designed to balance text quality at high zoom levels with PDF file size. PDF file sizes may be between 10-25% larger than when using Standard precision.

If the precision is set to High, all coordinates are rounded to 1/100th of a point. PDF file sizes may be between 20-50% larger than when using Standard precision.

If the precision is set to Maximum, no coordinates are rounded. PDF file sizes may be between 30-80% larger than when using Standard precision.

The options are

0 = Standard

1 = Improved

2 = High

3 = Maximum

For printing on an inkjet printer, standard precision will most likely be adequate. Viewing of complicated output on screen may require improved precision. Maximum precision may be reserved for PDF output to be imported into another application that requires the best precision.

Format: PDF_PRECISION = 0

PDF_LAYER_OUTPUT

Layer information can be stored in a PDF file. This can give the option for the user to turn layers on and off.

Option are

0 = None

1 = MicroStation Reference Files and Layers

Format: PDF_LAYERS = 1

PDF_LAYER_FORMAT  
PDF_LAYER_PRINT_AS_CREATED

If true the resulting PDF can only be printed with all layers displayed as created.

Options are "True" or "False"

Format: PDF_LAYER_PRINT_AS_CREATED = True

PDF_ALLOW_CHANGES

Used to control changes to the PDF.

0 = Allow unrestricted changes.

1 = Do not allow any changes.

2 = Allow inserting, deleting, and rotating pages.

3 = Allow filling in form fields and signing.

4 = Allow commenting, filling in form fields, and signing.

5 = Allow any changes except for extracting content and printing.

Default = 0

Format: PDF_ALLOW_CHANGES = 1

PDF_OWNER_PASSWORD Sets the owner password.
PDF_USER_PASSWORD Sets the user password.
PDF_ALLOW_PRINTING

Options for the printing permissions.

0 = Allowed

1 = Low res printing only

2 = No printing allowed

Default = 0

Table 2. WATERMARK_JUST Codes and Abbreviations
Justification Number Abbreviation 1 Abbreviation 2
Left Top Corner 0 TXTJUST_LT LT
Left Centre 1 TXTJUST_LC LC
Left Bottom Corner 2 TXTJUST_LB LB
Center Top Corner 6 TXTJUST_CT CT
Center Center 7 TXTJUST_CC CC
Center Bottom Corner 8 TXTJUST_CB CB
Right Top Corner 12 TXTJUST_RT RT
Right Centrer 13 TXTJUST_RC RC
Right Bottom Corner 14 TXTJUST_RB RB